groundsdk 7.7.2 API/com.parrot.drone.groundsdk.device.peripheral.stream/MediaReplay

MediaReplay

interface MediaReplay : Replay

Media replay stream control interface.

Provides control over some remote media stream, allowing to control playback.

Every client that requests a reference on a media replay stream is given its own dedicated instance of that stream. Multiple, independent stream may thus be open from the same media.

This stream does not support suspension. When it gets interrupted because another stream starts, or because streaming gets disabled globally, then it will move to the STOPPED state and will remain in that state even once the interrupting stream stops, or streaming gets enabled. Also, this implies that this stream cannot be started while streaming is globally disabled.

The stream is stopped and released as soon as the reference that provides it is closed. All open sinks are closed as a consequence.

Types

interface Source : Parcelable

Identifies a source for media replay.

Functions

@IntRange(from = 0)

abstract fun duration(): Long

Informs about total playback duration.

abstract fun openSink(@NonNull config: Stream.Sink.Config): Stream.Sink

Opens a sink from this stream.

abstract fun pause(): Boolean

Requests playback to pause.

abstract fun play(): Boolean

Requests playback to start.

abstract fun playState(): Replay.PlayState

Informs about current playback state.

@IntRange(from = 0)

abstract fun position(): Long

Informs about current playback position.

abstract fun seekTo(@IntRange(from = 0) position: Long): Boolean

Requests playback position change.

abstract fun source(): MediaReplay.Source

Informs about the configured source for this media replay stream.

abstract fun state(): Stream.State

Informs about current stream state.

abstract fun stop()

Stops the stream.

open fun videoTrackOf(@NonNull resource: MediaItem.Resource, @NonNull track: MediaItem.Track): MediaReplay.Source

Creates a source for streaming a media resource.